XIQS Update Price Plan

Update an existing Price Plan object whose Id is specified as first parameter. Following paramters are all optional.

Long id_priceplan

Price Plan Id

[String name] (named)

Price Plan Name

[String id_partition] (named)

Partition Id

[String id_operator] (named)

GSM Network Operator PLMN (MCC+MNC) code

String paytype (named)

Sim Type:
1 - Prepaid
3 - Postpaid

[String defaultplan] (named)

Set this Price Plan as Default Price Plan

[String slidctrl] (named)

SLID Management Support flag

[String maxrollover] (named)

Postpaid Roll Over Minutes (months)

[String alertstep] (named)

Call threshold limit alers (%)

[String smsalertstep] (named)

SMS threshold limit alert (%)

[String callconfee] (named)

Call Processing Credit Time (seconds); Call connection fee

[String mincallcharge] (named)

Call Connection Credit Time (seconds); Minimal Call billing period

[String stepcallcharge] (named)

Call Step Credit Time (seconds); Call billing increment

[String birthday] (named)

Postpaid Calendar Day (1-31); Indicate on which day of the month that SIM cards of the given price plan get new inclusive minutes

[String smsinterdelay] (named)

Inter SMS Delay (seconds)

[String callinterdelay] (named)

Inter Call Delay (seconds)

[String randinterdelay] (named)

Random parameter for Call/SMS delay (%)

[String id_hbs] (named)

HBS Scenario Id

[String cp_inclusivsec] (named)

Call Credit Peak Initial Credit (seconds)

[String cp_allowoverplan] (named)

Call Credit Peak Allow Over Plan flag

[String cp_allowcrossnet] (named)

Call Credit Peak Allow CrossNet flag

[String cop_inclusivsec] (named)

Call Credit Off Peak Initial Credit (seconds)

[String cop_allowoverplan] (named)

Call Credit Off Peak Allow Over Plan flag

[String cop_allowcrossnet] (named)

Call Credit Off Peak Allow CrossNet flag

[String cb_inclusivsec] (named)

Call Credit Bonus Initial Credit (seconds)

[String cb_allowoverplan] (named)

Call Credit Bonus Allow Over Plan flag

[String cb_allowcrossnet] (named)

Call Credit Bonus Allow CrossNet flag

[String sp_inclusivnb] (named)

SMS Credit Peak Initial Credit

[String sp_allowoverplan] (named)

SMS Credit Peak Allow Over Plan flag

[String sp_allowcrossnet] (named)

SMS Credit Peak Allow CrossNet flag

[String sop_inclusivnb] (named)

SMS Credit Off Peak Initial Credit

[String sop_allowoverplan] (named)

SMS Credit Off Peak Allow Over Plan flag

[String sop_allowcrossnet] (named)

SMS Credit Off Peak Allow CrossNet flag

[String sb_inclusivnb] (named)

SMS Credit Bonus Initial Credit

[String sb_allowoverplan] (named)

SMS Credit Bonus Allow Over Plan flag

[String sb_allowcrossnet] (named)

SMS Credit Bonus Allow CrossNet flag

[String ussdcommand] (named)

Depending on the method of Credit Check (USSD, SMS or USSD with SMS answer) it could be:
- USSD Script Command (for example "*121#")
- SMS Message, prefixed by SMS Server Number (for example "SMS+33100,SMS credit check")
- USSD Script Command waiting for response sent in SMS message (for example "USM*222#")

[Integer creditcheckmethod] (named)

Method used for creditcheck

[Integer flashtimeout] (named)

Delay (in seconds) before instant (flash) creditcheck is in timeout

[String ussdtrigger (named)

Credit Check Trigger (1-Manual, 2-Sim Release, 3-Remaining minutes, 4-Sim Registration, 5-Daily Sim Registration)

[String smsussdtrigger (named)

Credit Check via (1-USSD, 2-SMS, 3-USSD with SMS answer)

[String ussdsync] (named)

Credit Synchronization type (1-Automatic, 2-Manual)

[String checkondeactivate] (named)

Check Credit at Sim Deactivation

[String advantage0] (named)

Maximal gap allowed (%)

[String advantage1] (named)

Maximal gap allowed (minutes)

[String ussdnoportrestart] (named)

Restart Port Before Credit Check

[String additionalsms] (named)

Number of additional SMS that will be received

[String addsmsrequired] (named)

Mandatory additional SMS flag

[String ussdmatch] (named)

Message Returned for Valid USSD/SMS; Specify the template that describes the USSD/SMS string sent by the operator. The goal of the string format is to identify several variables into the USSD/SMS string.
'*' - Star can be used to bypass several characters, until the characters that follow the star was found.
'$' - Dollar sign is used to identify a part of the USSD string in which the variables can be found. A zone that contains variables is enclosed into two characters $.
'#i' - variable; 10 integer variables can be defined: #1, #2, #3, #4, #5, #6, #7, #8, #9, #10.
'<>' - Each variable definition is enclosed into a starting < and ending >.
'=' - Variable assignment as follow #i= ‘Expression’
‘Expression’ is a string that contain * to identify the variable value and some characters that specify where to find the values.
For example *hh specify that the value of the variable is the integer value that is just before text "hh".
If expression is not found then the variable value is 0.
Example: *credit is $<#1=*h><#2=*m><#3=*s>$                                                                                         

[String ussdmatch2] (named)

<deprecated>

[String ussdpeak] (named)

Specify how to compute Call Credit Peak (in seconds) from the variables; Enter an expression that use the variables (#1, #2, #3, #4, #5, #6, #7, #8, #9, #10) and operators ( + - * / ). Expression value is rounded to integer.
Example: #1 * 3600 + #2 * 60 + #3

[String ussdoffpeak] (named)

Specify how to compute Call Credit Off Peak (in seconds) from the variables; Format is the same as for the previous parameter

[String bonus] (named)

Specify how to compute Call Credit Bonus (in seconds) from the variables; Format is the same as for the previous parameter

[String smspeak] (named)

Specify how to compute SMS Credit Peak; Format is the same as for the previous parameter

[String smsoffpeak] (named)

Specify how to compute SMS Credit Off Peak; Format is the same as for the previous parameter

[String smsbonus] (named)

Specify how to compute SMS Credit Bonus; Format is the same as for the previous parameter

[String ussdstring] (named)

Valid sample of USSD/SMS returned message

[String ussdstring2] (named)

Valid sample of 2nd SMS returned message

[String ussdstring3] (named)

[String ussdstring4] (named)

[String ussdstring5] (named)

[String ussdstring6] (named)

[String ussdstring7] (named)

[String ussdstring8] (named)

[String ussdstring9] (named)

[String ussdstring10] (named)

[String nocreditfmt] (named)

Message Returned if out of credit

[String notnetfmt] (named)

Message Returned on Network failure

[String ussdresponse] (named)

The last received USSD/SMS message

[String ussdresponse2] (named)

The last received 2nd SMS message

[String ussdresponse3] (named)

[String ussdresponse4] (named)

[String ussdresponse5] (named)

[String ussdresponse6] (named)

[String ussdresponse7] (named)

[String ussdresponse8] (named)

[String ussdresponse9] (named)

[String ussdresponse10] (named)

[String topmode] (named)

Recharge mode:
0 - Manual
1 - Automatic
2 - By Allocation Rule

[String topmethod] (named)

Recharge SIM vie:
0 - IVR
1 - SMS
2 - USSD

[String topsmswait] (named)

Requirement for last SMS:
0 - None
1 - Notification
2 - SMS Replay

[String id_transferplan] (named)

Transfer Plan Id

[String topfor] (named)

Recharge SIM for:
0 - Call
1 - SMS
2 - Call & SMS

[String remainsec] (named)

Recharge SIM on remaining call credit

[String remainsmsnb] (named)

Recharge SIM on remaining SMS number

[String topnum] (named)

Recharge IVR/SMS Server number / USSD Script Command

[String topscript] (named)

Recharge IVR Script / SMS Message

[String ackivrnum] (named)

Confirmation IVR/SMS Server number / Supplementary USSD Script for Confirmation

[String ackivrscript] (named)

IVR Scritp/SMS message for Confirmation

[String topactivsim] (named)

Reactive SIM after recharge flag

[String topchkcredit] (named)

Check credit after recharge flag

[String activmode] (named)

Activation mode:
0 - Manual
1 - Automatic
2 - By Allocation Rule

[String activaction] (named)

Activation action:
0 - Sim card
1 - Promotion

[String activchkcredit] (named)

For Activation action Promotion, Check credit after activation flag

[String activpromoscript] (named)

For Activation action Promotion, Promotion Scheduler script

[String activmethod] (named)

Activation method:
0 - IVR
1 - SMS
2 - USSD

[String activsmswait] (named)

For Activation method SMS, Requirement for Last SMS:
0 - None
1 - Notification
2 - SMS Replay

[String activnum] (named)

Depending on Activation method:
- Activation number for IVR and SMS
- Activation USSD command for USSD
Can contain any of the following characters '1'..'9' '*' '#' '+', but also "%n" to specify simcard called number and ',' to separate USSD menu choices

[String activscript] (named)

Activation script for IVR and SMS Activation methods, depending on Activation method it can contain:
- For IVR any of the following characters '1'..'9' '*' '#' '+', but also "%n" to specify simcard called number, '.' meaning pause of 1 sec and ';' meaning pause of 5 sec 
- For SMS any text, "%n" to specify simcard called number

[String daymaxcalltime] (named)

Maximal daily Time on call (seconds)

[String daymaxcallmode] (named)

Maximal daily Time on call type:
0 - Billing time
1 - Real time

[String daymaxcallnb] (named)

Maximal daily number of Call Attempts

[String daymincalltime] (named)

Minimal daily Call Duration to Consider (seconds)

[String daymincallmode] (named)

Include non connected calls into Minimal daily Call Duration flag

[String daycallperiod] (named)

Call counter as per Block Time Period (seconds)

[String dayforcedisco] (named)

Force SIM deactivation call on limit reached

[String daymaxsms] (named)

Maximal daily number of sent SMS

[String daymaxsmserr] (named)

RESERVED FOR FUTURE USAGE

[String calldisablesim] (named)

Activate Call & False Answer Supervision flag                                                                                                               

[String callgeneric] (named)

Counter for Successve Non Connected Calls (0=OFF, take over any other cause)

[String callnodial] (named)

Counter for NO DIALTONE Cause handled from Network

[String callnocarrier] (named)

Counter for NO CARRIER Cause handled from Network

[String callcallerdisco] (named)

Counter for CALLER HANGUP Cause handled from Network

[String callbusy] (named)

Counter for CALL BUSY Cause handled from Network

[String callmsgonprogress] (named)

Counter for Provider Message Detection from SETUP

[String callmsgonring] (named)

Counter for Provider Message Detection from ALERTING

[String callmsgonconnect] (named)

Counter for Provider Message Detection from CONNECTION

[String callnoanswer] (named)

Counter for NO ANSWER Cause handled from Network

[String callunknownerr] (named)

Counter for Successive Unspecified Disconnection Cause (0=OFF)

[String smsdisablesim] (named)

Activate Successive SMS Disconnect Cause Counters flag (requires IRON Call Manager)

[String smsmaxerrnb] (named)

Counter for Successive SMS Unspecified Disconnection Cause

[String freechargetime] (named)

[String dayminlastcall] (named)

[String lowdurmaxnb] (named)

[String lowdurthreshold] (named)

[String areacodectl] (named)

[String daymaxrefillnb] (named)

[String daymaxactivnb] (named)

[String activsmsreply] (named)

[String activsmsreplytext] (named)

[String slidisunique] (named)

Specify when automatic generated SLID(s) should be unique for Sim Plan's partition.

[String disablecli] (named)

[String callprogressmode] (named)

[String inbanddelay] (named)

[String novoicetimeout] (named)

[String noconnecttimeout] (named)

[String slidformat] (named)

Format should be composed from at least 1 to maximum 3 range numbers  surrounded by '[' & ']', and numbers separated by '-'. If a fixed  number is specified (no '-' character), no random generation is done unless for '[0]' or range missing, that means totally random number generation.

i.e. following are valid SLID format:

[String vusedfmt] named

Message format voucher already used

[String vinvalidfmt] named

Message format invalid voucher

[String refillunavailfmt] named

Message format refill network/service failure

[String refilldeactivfmt] named

Message format refill sim blocked

[String refill1stfmt] named

Message format refill not enough credit

[String activdonefmt] named

Message format activation already activated

[String activunavailfmt] named

Message format activation network/service failure

[String activdeactivfmt] named

Message format activation sim blocked

[String ussdtimeout] named

[String activtimeout] named

[String activsync] named

[String activrefill1st] named

[String activusenow] named

[String refilltimeout] named

[String refillsync] named

[String othervoucherused] named

[String othervoucherinvalid] named

[String activafterrefill] named

[String refillafteractiv] named

[String idleinitdelay] named

[String smsdlrdelay] named

[String newslidperalloc] named

[String q931causevalue] named

[String q931maxsnc] named

[String validitydate] named

[String id_hbs2] named

[String hbsrule1] named

[String hbsrule2] named

[String dataalertstep] named

When ratio of used / inclusive data is below this percentage, Sim is visually marked as Orange

[String data_inclusivmb] named

Monthly amount of data

[String data_allowoverplan] named

Sim can used more than monthly amount of data

[String datarecharge] named

[String remaindatamb] named

[String dailylimitdata] named

Maximum amount of data allowed per day

[String dailylimitsmserror] named

[String smscallingnumber] named

[String daypass_timezone] named

Deprecated

[String daypass_lowspeeddata] named

Deprecated

[String startdate] named

Deprecated

[String timezone] named

Deprecated

[String numberofdays] named

Deprecated

[String firstuseactivation] named

[String data_offnet_inclusivmb] named

Monthly amount of data offnet

[String data_offnet_allowoverplan] named

Sim can used more than monthly offnet amount of data

[String multismscrotation] named

Integer: OK = 1

Error Data structure ( Error Management )

Possible failure code returns
 *ERR_CMD_SYNTAX (400) ERR_MSG_PPLAN_FD_ADDED or ERR_MSG_PPLAN_NO_FIELD
 *ERR_OBJ_NOT_FOUND (404) ERR_MSG_PPLAN_NOT_FOUND
 *ERR_UNAUTHORIZED (401) ERR_MSG_OBJ_NOT_OWNED
 *ERR_SRV_INTERNAL (500) ERR_MSG_NO_DB
                                                                                                               

getXIQSPricePlanList

createXIQSPricePlan

getXIQSPPSettingsInfo

getXIQSPPTopupInfo

getXIQSPPCreditInfo

getXIQSPPCreditCheckInfo

deleteXIQSPricePlan

getXIQSUSSDCreditCheckString